Skip to content

ci(release): version packages - #463

Merged
eXamadeus merged 1 commit into
mainfrom
changeset-release/main
Jul 24, 2026
Merged

ci(release): version packages#463
eXamadeus merged 1 commit into
mainfrom
changeset-release/main

Conversation

@the-faceter

@the-faceter the-faceter Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

This PR was auto-generated by the release workflow. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@agent-facets/adapter@0.28.0

Minor Changes

  • #438 d20cdae Thanks @eXamadeus! - BREAKING (pre-1.0 minor): the adapter asset contract is now tagged request/result unions instead of positional parameters, and the adapter API identifier advances from 0.0 to 0.1.
    installAsset, readAsset, and deleteAsset each take a single request object tagged by assetType and return a discriminated result — expected failures (not-found, invalid-companion-path, unsupported-scope, not-implemented, io-failed) are structured values, never thrown errors. Skill requests carry a companion byte map plus the caller-verified owned companion path set for atomic multi-file skill bundles; agent and command requests structurally cannot carry companions. defineAdapter stubs for omitted methods now return not-implemented failures instead of throwing.
    The SDK's canonical ADAPTER_API_VERSION is now 0.1, identifying this tagged contract; defineAdapter() stamps it and first-party packages publish "facetAdapterApiVersion": "0.1". 0.0 named the earlier positional contract: a CLI that supports only 0.1 classifies a 0.0 adapter as well-formed but unsupported and fails closed (before any contract method or project write) with reinstall guidance. There is no positional/tagged compatibility bridge — an adapter built against 0.0 must be rebuilt against a 0.1 SDK release and reinstalled.
    New SDK helpers: installSkillBundle / readSkillBundle / deleteSkillBundle (staged all-or-nothing bundle replacement with rollback, ownership-set-based deletion, and empty-directory pruning), installSingleFileAsset / readSingleFileAsset / deleteSingleFileAsset (result-shaped single-file operations), and validateContainedRelativePath (pre-filesystem containment validation applied to every supplied companion path).
    Every adapter implementing the previous positional contract must migrate. The first-party claude-code, opencode, and codex adapters are migrated in their matching minor releases; codex delete operations now prune emptied directories consistently with the other adapters.
    Release ordering: this SDK release and the three first-party adapter releases publish 0.1 to npm before any agent-facets CLI release requires 0.1. Until that CLI ships, existing 0.0 CLIs keep selecting the highest compatible 0.0 adapter release, so this changeset intentionally carries no agent-facets bump — the CLI change that makes 0.1 the supported set lands in a later release cycle gated on all three first-party adapters having published facetAdapterApiVersion: 0.1.

@agent-facets/adapter-claude-code@0.9.0

Minor Changes

  • #438 d20cdae Thanks @eXamadeus! - BREAKING (pre-1.0 minor): the adapter asset contract is now tagged request/result unions instead of positional parameters, and the adapter API identifier advances from 0.0 to 0.1.
    installAsset, readAsset, and deleteAsset each take a single request object tagged by assetType and return a discriminated result — expected failures (not-found, invalid-companion-path, unsupported-scope, not-implemented, io-failed) are structured values, never thrown errors. Skill requests carry a companion byte map plus the caller-verified owned companion path set for atomic multi-file skill bundles; agent and command requests structurally cannot carry companions. defineAdapter stubs for omitted methods now return not-implemented failures instead of throwing.
    The SDK's canonical ADAPTER_API_VERSION is now 0.1, identifying this tagged contract; defineAdapter() stamps it and first-party packages publish "facetAdapterApiVersion": "0.1". 0.0 named the earlier positional contract: a CLI that supports only 0.1 classifies a 0.0 adapter as well-formed but unsupported and fails closed (before any contract method or project write) with reinstall guidance. There is no positional/tagged compatibility bridge — an adapter built against 0.0 must be rebuilt against a 0.1 SDK release and reinstalled.
    New SDK helpers: installSkillBundle / readSkillBundle / deleteSkillBundle (staged all-or-nothing bundle replacement with rollback, ownership-set-based deletion, and empty-directory pruning), installSingleFileAsset / readSingleFileAsset / deleteSingleFileAsset (result-shaped single-file operations), and validateContainedRelativePath (pre-filesystem containment validation applied to every supplied companion path).
    Every adapter implementing the previous positional contract must migrate. The first-party claude-code, opencode, and codex adapters are migrated in their matching minor releases; codex delete operations now prune emptied directories consistently with the other adapters.
    Release ordering: this SDK release and the three first-party adapter releases publish 0.1 to npm before any agent-facets CLI release requires 0.1. Until that CLI ships, existing 0.0 CLIs keep selecting the highest compatible 0.0 adapter release, so this changeset intentionally carries no agent-facets bump — the CLI change that makes 0.1 the supported set lands in a later release cycle gated on all three first-party adapters having published facetAdapterApiVersion: 0.1.

@agent-facets/adapter-codex@0.7.0

Minor Changes

  • #438 d20cdae Thanks @eXamadeus! - BREAKING (pre-1.0 minor): the adapter asset contract is now tagged request/result unions instead of positional parameters, and the adapter API identifier advances from 0.0 to 0.1.
    installAsset, readAsset, and deleteAsset each take a single request object tagged by assetType and return a discriminated result — expected failures (not-found, invalid-companion-path, unsupported-scope, not-implemented, io-failed) are structured values, never thrown errors. Skill requests carry a companion byte map plus the caller-verified owned companion path set for atomic multi-file skill bundles; agent and command requests structurally cannot carry companions. defineAdapter stubs for omitted methods now return not-implemented failures instead of throwing.
    The SDK's canonical ADAPTER_API_VERSION is now 0.1, identifying this tagged contract; defineAdapter() stamps it and first-party packages publish "facetAdapterApiVersion": "0.1". 0.0 named the earlier positional contract: a CLI that supports only 0.1 classifies a 0.0 adapter as well-formed but unsupported and fails closed (before any contract method or project write) with reinstall guidance. There is no positional/tagged compatibility bridge — an adapter built against 0.0 must be rebuilt against a 0.1 SDK release and reinstalled.
    New SDK helpers: installSkillBundle / readSkillBundle / deleteSkillBundle (staged all-or-nothing bundle replacement with rollback, ownership-set-based deletion, and empty-directory pruning), installSingleFileAsset / readSingleFileAsset / deleteSingleFileAsset (result-shaped single-file operations), and validateContainedRelativePath (pre-filesystem containment validation applied to every supplied companion path).
    Every adapter implementing the previous positional contract must migrate. The first-party claude-code, opencode, and codex adapters are migrated in their matching minor releases; codex delete operations now prune emptied directories consistently with the other adapters.
    Release ordering: this SDK release and the three first-party adapter releases publish 0.1 to npm before any agent-facets CLI release requires 0.1. Until that CLI ships, existing 0.0 CLIs keep selecting the highest compatible 0.0 adapter release, so this changeset intentionally carries no agent-facets bump — the CLI change that makes 0.1 the supported set lands in a later release cycle gated on all three first-party adapters having published facetAdapterApiVersion: 0.1.

@agent-facets/adapter-opencode@0.10.0

Minor Changes

  • #438 d20cdae Thanks @eXamadeus! - BREAKING (pre-1.0 minor): the adapter asset contract is now tagged request/result unions instead of positional parameters, and the adapter API identifier advances from 0.0 to 0.1.
    installAsset, readAsset, and deleteAsset each take a single request object tagged by assetType and return a discriminated result — expected failures (not-found, invalid-companion-path, unsupported-scope, not-implemented, io-failed) are structured values, never thrown errors. Skill requests carry a companion byte map plus the caller-verified owned companion path set for atomic multi-file skill bundles; agent and command requests structurally cannot carry companions. defineAdapter stubs for omitted methods now return not-implemented failures instead of throwing.
    The SDK's canonical ADAPTER_API_VERSION is now 0.1, identifying this tagged contract; defineAdapter() stamps it and first-party packages publish "facetAdapterApiVersion": "0.1". 0.0 named the earlier positional contract: a CLI that supports only 0.1 classifies a 0.0 adapter as well-formed but unsupported and fails closed (before any contract method or project write) with reinstall guidance. There is no positional/tagged compatibility bridge — an adapter built against 0.0 must be rebuilt against a 0.1 SDK release and reinstalled.
    New SDK helpers: installSkillBundle / readSkillBundle / deleteSkillBundle (staged all-or-nothing bundle replacement with rollback, ownership-set-based deletion, and empty-directory pruning), installSingleFileAsset / readSingleFileAsset / deleteSingleFileAsset (result-shaped single-file operations), and validateContainedRelativePath (pre-filesystem containment validation applied to every supplied companion path).
    Every adapter implementing the previous positional contract must migrate. The first-party claude-code, opencode, and codex adapters are migrated in their matching minor releases; codex delete operations now prune emptied directories consistently with the other adapters.
    Release ordering: this SDK release and the three first-party adapter releases publish 0.1 to npm before any agent-facets CLI release requires 0.1. Until that CLI ships, existing 0.0 CLIs keep selecting the highest compatible 0.0 adapter release, so this changeset intentionally carries no agent-facets bump — the CLI change that makes 0.1 the supported set lands in a later release cycle gated on all three first-party adapters having published facetAdapterApiVersion: 0.1.

Note

Medium Risk
Publishes a breaking pre-1.0 adapter contract (0.1) that forces third-party adapter rebuilds; lockfile schema change may affect tooling that reads facets.lock.

Overview
Automated release PR that bumps @agent-facets/adapter to 0.28.0 and the claude-code, opencode, and codex adapter packages to matching minors, with changelog entries for the adapter API 0.00.1 breaking change from #438. The consumed changeset is removed and bun.lock version pins are updated accordingly; there is no agent-facets CLI bump in this cycle.

facets.lock moves to lockfileVersion 0.2, adding per-asset files entries (relative path + sha256 integrity) for every locked facet asset instead of name-only asset records.

Reviewed by Cursor Bugbot for commit 95e8cc6. Bugbot is set up for automated code reviews on this repo. Configure here.

@the-faceter
the-faceter Bot force-pushed the changeset-release/main branch 7 times, most recently from 43a1d43 to 4295ad6 Compare July 24, 2026 05:02
@the-faceter
the-faceter Bot force-pushed the changeset-release/main branch from 4295ad6 to 95e8cc6 Compare July 24, 2026 05:03
@eXamadeus
eXamadeus merged commit 2e67efd into main Jul 24, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant